home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / ypfiles.z / ypfiles
Encoding:
Text File  |  1998-10-20  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. YYYYPPPPFFFFIIIILLLLEEEESSSS((((4444))))                                                          YYYYPPPPFFFFIIIILLLLEEEESSSS((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ypfiles - the NIS database and directory structure
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The network information service (NIS) uses a database of _m_d_b_m(3B) files
  13.      in the directory hierarchy at /_v_a_r/_n_s/_d_o_m_a_i_n_s.  A _m_d_b_m database consists
  14.      of a files created by calls to the _m_d_b_m library package.  Typically these
  15.      have a name ending in ....mmmm For instance, the database named _h_o_s_t_s._b_y_n_a_m_e,
  16.      is implemented by the file _h_o_s_t_s._b_y_n_a_m_e._m . A _m_d_b_m database served by the
  17.      NIS is called a NIS _m_a_p.  A NIS _d_o_m_a_i_n is a named set of NIS maps. Each
  18.      NIS domain is implemented as a subdirectory of /_v_a_r/_n_s/_d_o_m_a_i_n_s containing
  19.      the map.  Any number of NIS domains can exist.  Each may contain any
  20.      number of maps.
  21.  
  22.      No maps are required by the NIS lookup service itself, although they may
  23.      be required for the normal operation of other parts of the system.  There
  24.      is no list of maps which NIS serves - if the map exists in a given
  25.      domain, and a client asks about it, the NIS will serve it.  For a map to
  26.      be accessible consistently, it must exist on all NIS servers that serve
  27.      the domain.  To provide data consistency between the replicated maps,
  28.      entries to run _y_p_x_f_r periodically exist in /_u_s_r/_s_p_o_o_l/_c_r_o_n/_c_r_o_n_t_a_b_s/_r_o_o_t
  29.      on each server.  More information on this topic is in _y_p_x_f_r(1M).
  30.  
  31.      NIS maps should contain two distinguished key-value pairs.  The first is
  32.      the key YP_LAST_MODIFIED, having as a value a ten-character ASCII order
  33.      number.  The order number should be the UNIX time in seconds when the map
  34.      was built.  The second key is YP_MASTER_NAME, with the name of the NIS
  35.      master server as a value. _m_a_k_e_m_d_b_m(1M) generates both key-value pairs
  36.      automatically.  A map that does not contain both key-value pairs can be
  37.      served by the NIS, but the _n_s_d process will not be able to return values
  38.      for ``Get order number'' or ``Get master name'' requests. In addition,
  39.      values of these two keys are used by _y_p_x_f_r when it transfers a map from a
  40.      master NIS server to a slave. If _y_p_x_f_r cannot figure out where to get the
  41.      map, or if it is unable to determine whether the local copy is more
  42.      recent than the copy at the master, you must set extra command line
  43.      switches when you run it.
  44.  
  45.      NIS maps must be generated and modified only at the master server.  They
  46.      are copied to the slaves using _y_p_x_f_r(1M) to avoid potential byte-ordering
  47.      problems among NIS servers running on machines with different
  48.      architectures, and to minimize the amount of disk space required for the
  49.      _m_d_b_m files.  The NIS database can be initially set up for both masters
  50.      and slaves by using _y_p_i_n_i_t(1M).
  51.  
  52.  
  53.      After the server databases are set up, it is probable that the contents
  54.      of some maps will change.  In general, some ASCII source version of the
  55.      database exists on the master, and it is changed with a standard text
  56.      editor.  The update is incorporated into the NIS map and is propagated
  57.      from the master to the slaves by running /_v_a_r/_y_p/_y_p_m_a_k_e.  _y_p_m_a_k_e executes
  58.      the file /_v_a_r/_y_p/_m_d_b_m__p_a_r_s_e and logs its activity in /_v_a_r/_y_p/_y_p_m_a_k_e._l_o_g.
  59.      /_v_a_r/_y_p/_m_d_b_m__p_a_r_s_e contains functions for all supplied maps; if you add a
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. YYYYPPPPFFFFIIIILLLLEEEESSSS((((4444))))                                                          YYYYPPPPFFFFIIIILLLLEEEESSSS((((4444))))
  71.  
  72.  
  73.  
  74.      NIS map, edit this file to support the new map.  The script uses _y_p_p_u_s_h
  75.      to propagate the changed map to the slaves.  _y_p_p_u_s_h is a client of the
  76.      map _y_p_s_e_r_v_e_r_s , which lists all the NIS servers. For more information on
  77.      this topic, see _y_p_p_u_s_h(1M).
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      makemdbm(1M), ypinit(1M), ypmake(1M), ypxfr(1M), yppush(1M), yppoll(1M),
  81.      nsd(1M), rpcinfo(1M), mdbm(3B), nis(7P)
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.